SurveyCake 串接 Ragic 四步骤教学

如果你是 SurveyCake 专业版（或以上）方案订户，只要透过以下步骤，即使不会写程序也能自助串接 Ragic，让 SurveyCake 问卷结果直接传到指定的 Ragic 表单。

步骤一：创建 SurveyCake 问卷与 Ragic 表单

设置串接前，要先把你希望串接的 SurveyCake 问卷、以及对应的 Ragic 表单创建好。举例来说，如果你在 SurveyCake 创建了一张“商品试用申请”问卷，希望申请者填写的姓名、电话、肌肤状况等信息可以直接传入你的 Ragic 数据库，那么除了“商品试用申请”问卷，你也要在 Ragic 创建对应的“试用申请”表单、创建对应的字段。

Ragic 表单与字段名称不需要和 SurveyCake 问卷一模一样，可以有其他 SurveyCake 上没有的字段（例如自动给流水号的自动生成字段值、自动显示数据创建时间的默认值字段）或其他状态/扩展信息字段。

小技巧：如果题目很多，创建好 SurveyCake 问卷后，可以考虑到后台“明细汇出”区块将题目汇出成 Excel / CSV 檔后，到 Ragic 用汇入的方式来创建表单，再依需求微调字段/种类，节省时间。

步骤二：设置 SurveyCake 字段别名

两方的问卷 / 表单确定创建完成后，就要先做第一步设置：要先告诉 SurveyCake 系统，你希望问卷的某个题目，之后要传到 Ragic 的哪个字段？

我们要用 SurveyCake 的“别名”功能达到这个效果，在每个要串接的题目上，设置带有 Ragic 对应字段编号信息的别名，这样之后计算机就能辨认要把信息传给哪个字段。

别名设置规则是：

若为一般题目 / 非 key 值字段，别名应设为 ragic_字段编号；

若要设置 Ragic 表单的 key 值（唯一值）字段，别名应设置为 ragic_key_字段编号。

举例来说，假设回覆数据中独一无二的值会是“姓名”，申请者不会有重复的姓名，而 Ragic 表单姓名字段编号是 1234567 的话，在 SurveyCake 要设置的别名就会是 ragic_key_1234567；“肌肤状态”Ragic 字段编号是 1000889 的话，在 SurveyCake 要设置的别名就会是 ragic_1000889 。

Key 值字段在此的效果为：判断要“新增”或“更新”问卷数据的依据。假设有个试用申请者叫“黄大柴”他第一次联络数据填错、想要更新的话，重新填一次问卷并填上同样的姓名，Ragic 就会依据姓名这个 Key 值字段，直接更新既有“黄大柴”数据里的联络信息（而不会另外新增一笔重复数据）。

当然如果申请者可能有同名同姓情况的话，就不适合用姓名当 Key 值，可另取“试用编号”或其他可用来辨认填答者的题目。

步骤三：在 SurveyCake 设置 Webhook URL

Ragic 和 SurveyCake 的串接是利用 SurveyCake 的 webhook 功能达成的，因此指定完字段别名后，要到系统通知 > webhook 区块来设置 Ragic 这边对应的 Webhook URL。

Webhook URL 会根据你要串接的 Ragic 表单、你采用的 SurveyCake 方案而有所不同。以下分别说明不同情况下 Webhook URL 的组成规则：

SurveyCake 专业版 / 团队版方案

如果你已经是 Ragic 老手，知道怎么从表单网址得知自己数据库所在的服务器（server）、数据库帐号（apname）、页签路径（path）、表单路径（sheetIndex），直接依此规则设置 Webhook URL 并保存即可：

https://{server}.ragic.com/cust/surveycake/webhook.jsp?a={apname}&p={path}&si={sheetIndex}

举例来说，若表单网址是：

ap5.ragic.com/surveycakebd/forms7/2

应设置的 Webhook URL 就是：

https://ap5.ragic.com/cust/surveycake/webhook.jsp?a=surveycakebd&p=forms7&si=2

若还不太清楚，可参阅下方图解与这份文档的说明。

SurveyCake 企业版方案

SurveyCake 企业版若有自订域，串接规则会略有差异，为：

https://{server}.ragic.com/cust/surveycake/webhook.jsp?a={apname}&p={path}&si={sheetIndex}&domain={yourcustomdomain}

其中 {yourcustomdomain} 要填入自订的专属域（例如 surveycakebd.surveycake.biz ）。

设置好 Webhook URL 可以先不要关窗口，我们要用下方的“Webhook 译码”信息，到 Ragic 完成最后一步设置。

步骤四：在 Ragic 设置对应的“全域常量”

打开 Ragic 全域常量表单，最后一步是我们要把刚才“Webhook 译码”区块提供的两组“钥匙”：该张问卷的 Hash Key 和 IV Key，创建成全域常量表单的两笔数据，让 Ragic 获取串接时所需的信息。

Hash Key “常量名称”的命名规则是：

surveycake_{path}_{sheetIndex}_hashkey

IV Key “常量名称”的命名规则是：

surveycake_{path}_{sheetIndex}_ivkey

字段值则分别填上“Webhook 译码”区块提供的对应信息即可，请参阅下方范例。

完成！

设置完成之后可以测试填答一次问卷，很快就可以在 Ragic 表单看到对应数据。

进阶说明

SurveyCake 问卷填答数据串接 Ragic 的好处很多，你可以对数据做进一步的汇整运用、让数据更有意义地链接、集成 Ragic 的提醒、指派、签核等功能，以下说明一些实用的进阶操作方式。（更多情境说明可见这里）。

（一）汇整多阶段问卷

如果你要针对同样一群对象，发送多次问卷，且每次题目都有些不同，过去可能需要汇出后手动统整。现在你可以利用 Ragic 多版本表单搭配共享特定 Key 值字段的功能，轻松汇整多阶段问卷。

举例来说，品牌保养品试用计画，问卷分为“试用前”、“试用中”、“试用后”三阶段发放，希望之后将同一位试用者不同阶段的填答结果，自动汇整到同一笔数据中，那首先可以分别设计 3 张试用计画针对不同阶段的问卷， 3 张问卷只需要有一个共同可识别的题目即可，例如“试用编号”。

发送问卷时，利用 SurveyCake“默认值”功能自动带入要发放的“试用编号”内容，同一位填答者不同阶段问卷给予相同试用编号。

而在 Ragic 这边，设计 3 张对应表单时，需要将这 3 张表单设计为数据相连的多版本工作表（可以先设计第一张后利用多版本工作表的功能，创建出第二张、第三张），其中“试用编号”要是 3 张表单共用（字段编号相同）的字段。

接着循一般串接步骤，将 3 张问卷分别设置对应串接的 3 张 Ragic （多版本）表单，并将“试用编号”均设为 key 值字段。

完成设置后，就可以在 Ragic 表单中检视汇整后的数据了。

可以如同上图，在 Ragic 最后一阶段的表单显示所有字段，查看到所有信息，其他两张表单有需要的话可以隐藏部分字段；也可以在三张表单之外，另外拷贝一张包含所有共同字段的“总表”查看全部信息，依偏好自行决定即可。

（二）数据转入后在 Ragic 自动送签核

如果你有在串接的 Ragic 表单上设置签核流程，勾选“新建数据后自动开始签核”的进阶设置，有人填写问卷时，不仅数据会传送到 Ragic 表单，该笔数据也会自动送签，节省手动送签的精力，对于加快企业内部流程很有帮助。

这里要注意的是，由于 SurveyCake 串接传送数据过去时，系统是视同未登录的用户在新增数据，此时要记得在 Ragic 表单上给予未登录用户 - "EVERYONE" 群组“问卷式用户”以上的访问权限，才能自动送签。